H5R_GET_REGION

The H5R_GET_REGION function retrieves a dataspace associated with a region reference.

Example

Assuming the file, 'hdf5_out.h5' was created using the example in H5F_CREATE, the dataspace region saved in the reference attached to the “Hanning” dataset could be obtained as follows:

fid = H5F_OPEN('hdf5_out.h5')

dataset_id = H5D_OPEN(fid,'Hanning')

attr_id = H5A_OPEN_NAME(dataset_id,'Ref')

ref = H5A_READ(attr_id)

dataspace_id = H5R_GET_REGION(dataset_id,ref)

Syntax

Result = H5R_GET_REGION(Dataset_id, Reference)

Return Value

The Result gives the identifier of the dataspace with the region selected.

Arguments

Dataset_id

An integer giving the identifier in which the reference dataset is located.

Reference

An H5 reference structure giving the reference number to open.

Keywords

None

Version History

6.2	Introduced

See Also

H5R_CREATE, H5D_CREATE, H5D_CLOSE